home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / recent2 / playtrack.lha / PlayTrack.doc < prev   
Text File  |  1997-04-17  |  6KB  |  182 lines
  1.                         PlayTrack V1.0 by Stuart A. MacLean
  2.  
  3. IMPORTANT:
  4.  
  5. Distribution of PlayTrack
  6.  
  7. PlayTrack is FREEWARE. The author gives permission for PlayTrack to be
  8. freely distributed providing that no commercial gain is made from its
  9. distribution, and no modification is made either to the code or this
  10. document.
  11.  
  12.  
  13. DISCLAIMER
  14.  
  15. This software is provided "as-is" and the author accepts no responsibility
  16. for damage and/or loss of data/equipment resulting from the use of this
  17. software. (This is not very likely as I have tested this software very
  18. extensively on my system ;-) )
  19.  
  20. This archive should contain the following files.
  21.  
  22.     PlayTrack : main program.
  23.     PlayTrack.prefs : preference program.
  24.     PlayTrack.doc : this documentation file.
  25.     Source/PlayTrack.s : source code for this program.
  26.     Source/Resource.h : C include file for resource functions.
  27.     Source/Resource.i : assembler file for resource functions.
  28.     Source/Resource.s : a copy of my resource function source code.
  29.     Source/Resource.o : a link file of Resource.s
  30.  
  31. I have decided to include the source code so that you may use some its
  32. functions in your own programs if you wish.
  33.  
  34. PlayTrack is (C) 1997 by Stuart A. MacLean of X-Reality Software Ltd.
  35.  
  36.  
  37. WHAT IS PLAYTRACK?
  38.  
  39. PlayTrack is a CDDA player which works via a simple command line interface
  40. which allow the you to select what tracks you want to listen to from your
  41. CD. PlayTrack works by sampleing the audio information from the CD-ROM
  42. and playing it back through the Amiga's sound hardware using a recoded
  43. rendition of Christian Buchner's 14-bit audio device.
  44.  
  45. Unfortunately however PlayTrack will only work on CD-ROM drives which have
  46. the ability to read samples from CDDA formated CD-ROMs. Such drives that I
  47. know that have this ability are:
  48.  
  49.     TOSHIBA-3401
  50.     APPLE CD-150
  51.     APPLE CD-300
  52.     PLEXTOR 4x+ (this is the one I use)
  53.  
  54. From what I can I understand it is only some SCSI-II CD-ROMs which have
  55. this ability (but then again I maybe wrong) - If this program works on
  56. your CD-ROM and it is not one of the above mentioned then drop me an
  57. e-mail and tell me about it.
  58.  
  59. INSTALLATION:
  60.  
  61. The first thing you will need to is configure the preferences file
  62. which called (obviously) "PlayTrack.prefs" which should be copied
  63. into your S: directory.
  64.  
  65. There are three attributes present in this file DEVICE,UNIT,QUALITY.
  66.  
  67. DEVICE should be set to the device name of which your Amiga uses to
  68. talk to your CD-ROM driver.
  69.  
  70. e.g. To use "gvpscsi.device" : DEVICE=gvpscsi.device 
  71.  
  72. UNIT is the unit number of your CD-ROM driver is set to.
  73.  
  74. e.g. If your CD-ROM is unit number 3 : UNIT=3
  75.  
  76. QUALITY is the playback quality that the 14-bit playback routine will
  77. use. With 1 being the highest quality (but also 1 might be physically
  78. impossible to playback through your audio hardware at the correct
  79. playback speed) with the number increaseing as the quality decreases.
  80. I personally recommending setting this to '2' but if you don't have
  81. the CPU speed to handle 14-bit conversion then use a higher numerical
  82. setting.
  83.  
  84. e.g. Setting quality to 2 : QUALITY=2
  85.  
  86. Example of prefs file put together:
  87.  
  88. DEVICE=gvpscsi.device
  89. UNIT=3
  90. QUALITY=2
  91.  
  92.  
  93. The preference file should then be saved in your S: directory.
  94.  
  95. Now copy PlayTrack to where you want to put it (most likely C:)
  96. and ya-bing you are ready to go.
  97.  
  98.  
  99. REQUIREMENTS:
  100.  
  101. The minimum requirements are:
  102.  
  103.     Kickstart 2.04
  104.  
  105.     MC68020-processor
  106.     
  107. and
  108.  
  109.     A CD-ROM drive capable of reading CDDA samples from disk.
  110.     
  111.  
  112. USAGE:
  113.  
  114. The usage couldn't be any more simpler. To run type "PlayTrack" and this
  115. is followed by the number's of the different tracks that you want to play.
  116.  
  117. e.g. To play tracks 1, 3, 4 and 7 type.
  118.  
  119. PlayTrack 1 3 4 7
  120.  
  121. When playing CTRL-D can be used to skip a track and CTRL-C can be used
  122. to exit the program.
  123.  
  124.  
  125.  
  126. HOW DOES PLAYTRACK WORK?
  127.  
  128. PlayTrack deviates greatly from the standard CD-ROM player in that
  129. it doesn't play the CD back by using the CD-ROM drive exactly as
  130. a HI-FI CD player would play back CDs, in which only the hardware
  131. inside the CD-ROM is used.
  132.  
  133. Instead the sample information is read from the CD-ROM into memory
  134. from which it can then be replayed back through the Amiga's audio
  135. hardware using a 14-bit player.
  136.  
  137. So the main program contains two parts which work together in a
  138. continous loop:
  139.  
  140. 1)Reading the sample information from the CD-ROM into memory.
  141.  
  142. 2)Taking the sample and playing it back through the 14-bit player.
  143.  
  144. This cycle uses 3 buffers in memory which are continously recycled
  145. around and around, to give the full effect of a continously playing
  146. sample.
  147.  
  148. On top of this I have used a series of resource and error handlers
  149. which can deal with allocating and freeing any resources which are
  150. used by the program. Also it detects any errors which occurs due
  151. to failer to allocate the appropriate resource.
  152.  
  153. At this point I should give a big thank you to Christain Buchner for
  154. his work on his CyberSound program without which I would not have been
  155. able to write this program.
  156.  
  157.  
  158. BUGS:
  159.  
  160. Please report all bugs to me if you find any.
  161.  
  162. The fact that playtrack will is crackle and seem to be scratched when you
  163. are doing heavy disk accessing, processor or blitter intensive operations
  164. is due to the fact that the CD-ROM is not able to get the information from
  165. the CD-ROM effectively enough due to other hardware interference.
  166.  
  167.  
  168. HISTORY:
  169.  
  170. PlayTrack is a desendant of an old but still on going project which I have
  171. come back to again after a peroid of leaving it to rest - This is AudioCD
  172. which you may have heard about as I did released a beta-test back in Autumn
  173. 1996. The program caused to many crashes and failures so I left but when
  174. I came back to this I wrote this program first before going back to rework
  175. on AudioCD as test programming to see if I could improve the code. This I
  176. did and I was so pleased with the result I decided to release it.
  177.  
  178.  
  179. HOW TO CONTACT ME:
  180.  
  181. I can be contacted across e-mail via <smaclean@cs.strath.ac.uk>
  182. or you can telephone me on (Britain) 01360-770388.